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To the stars through the Apple II 

It was a hotel breakfast and my wife and I, as usual, each ordered a large 
orange juice, small for the kids. The waitress soon came back with huge 16- 
ounce glasses for my wife and I, and the kids got the 8-ounce glasses we 
expected for ourselves. 'Toto," I mumbled, "we're not in California anymore." 

And, in fact we weren't We were in the Sun Dome Best Western on the 
outskirts of Hutchinson, two hours east of Dodge City, an hour northwest of 
Wichita, or four, hard, two-kids-in-the-back-seat hours southwest of Overland 
Park. We were in Hutchinson to spend Thanksgiving at my sister's house. 

Hutchinson is no Big Apple, of course, but neither is anyplace eSse 
outside of Manhattan borough. Manhattan Kansas calls itself the Little Apple, 
but Hutchinson, perhaps wary of the trademark police, doesn't claim to be 
any kind of apple whatsoever. In fact if you don't count my sister's house, 
Hutchinson has just three major attractions. 

First of all, Hutchinson is the world-wide headquarters for Dillons stores. 
Possibly only a fewof you can appreciate the spiritual renewal a grocery store 
connoisseur feels on a pilgrimage to this Mecca, A visit to any Dillons, to 
browse the wide aisles lined with everything from apple pies to zwieback 
toast always makes me feel close to heaven. In Hutchinson, that's the only 
kind of grocery store they have. 

Secondly, every summer Hutchinson is the site of the Kansas State Fair. 
Things are kind of quiet over at the fairgrounds Thanksgiving weekend, 
however. Ho amazing snake women, no cowboys on horseback, and no road 
apples. 

The third andgreatest attraction of Hutchinson is the Kansas Cosmosphere 
and Space Center. This is one of the world's handful of mqjor aerospace 
museums, jutting from the plains of Kansas just where you'd least expect to 
find it The museum has over $100 million worth of space artifacts on display. 
For example, in the center of the main hall is a complete lunar lander. 
Outstanding exhibits trace the evolution of space flight from man's first 
liquid fuel rockets to actual spacecraft from the OS. Mercury, Gemini, and 
Apollo programs. 

The space capsules are displayed in such a way that you can get up close 
and see into the cockpits. Hands-on computerized exhibits letyou experience 
such things as the sounds and window view during your choice of several 
lunar landings or ascents. A computerized Astronaut Data Bank answers 
questions and displays a digitized image of your favorite astronaut A 
computerized display explains the functions of the controls in the Apollo 
command module. A computerized lunar geology exhibit displays your 
choice of videodisk photographs of the moon's surface. 

During the summer, the space center runs seven one-week sessions of a 
summer camp called the Future Astronaut Training Program. Any student 
about to enter the 7 th, 8th, or 9th grade can attend. At the camp, each 
student gets a chance to fly a variety of computerized trainers and 
simulators, including a M-size Manned Maneuvering Unit (jet pack), a flight 
trainer, and an 80 per cent scale Falcon Space Shuttle flight deck. Each of 
these simulators is big enough to sit in, and each is connected to computer 
and mechanical equipment that makes it raise, lower,, tilt, and roll in 
response to student commands. The kids in the shuttle simulator are even 
directed by other kids in a computerized Mission Control simulator. (For 
more Information about the center or the camp write to 1100 H. Plum, 
Hutchinson, KS 6750X or call 316-662-2305.) 

But why do you suppose I'm doing a museum review here in Open- 
Apple? That's right ... euery computer in the museum is an Apple U. 



From the Omnimax wrap-around theater's reservation system, which is 
built into a counter in the lobby, to the accounting and administration offices, 
to the computers controlling the equipment that tilts and rolls the simulators, 
to the lunar geology videodisk display— computers are everywhere, and 
each one is an Apple II. 

Many of the computers are in central equipment closets, to make servicing 
easy, and are hooked to the exhibits by long keyboard and video wires. 
Displays that have just a few buttons are actually connected to game paddle 
ports via resistor arrays so that when a button is pushed what the Apple 11 
actually "sees" is a game paddle movement According to the center's 
computer specialist, Ron Bloss, such an arrangement is immune to noise 
and allows the computers to be connected to the displays with hundreds of 
feet of cable. 

I asked Bloss whether they were using any accelerators with their Apples, 
"no," he said, "we haven't seen a need for that yet except maybe in 
accounting" 

Even though the space center uses nothing but Apple lis and is a high- 
technology education-based institution, Apple Computer doesn't appear on 
the long list of corporate supporters just inside the door. "We've tried to get 
some recognition from Apple," Bloss said, "but haven't gotten any response 
from them. They did finally let us purchase equipment through their 
education program, but other than that they've just ignored us." 

And what about the future of the Apple I! at the center? "As a matter of fact 
we are about to decide whether to start using MS-DOS based machines," 
Bloss said. "When you can get an XT turbo clone with a hard disk for about 
half the price of a llgs without a hard disk, it becomes very difficult to justify 



heard rumors of AppleTalk on the Apple II, we can't make plans based on 
rumors." 

Ho, Toto, this sure isn't Cupertino. You can't smell Apple's marketing 
smoke out here on the plains of Kansas and you can't see Apple's vision. But 
you can get a taste of what life's really like in the Apple II kingdom. You can 
shake hands with people who have built themselves a small Smithsonian- 
quality museum (and the largest tourist center in Kansas) on the back of the 
Apple 1 L And you can hear the crunching jaws of the clones, eating their way 
into Apple's markets. 




I TELLYA I'M STILL GETTING [NTERfERENCE — 

- COOKIE, RAfiS? R«3S WWW COOKIE? - 

THERE ITGOE5 4GAIN." 



3.90 Open-Apple 

Claris and its cash cow 

Claris, Apple's infant software company, was featured in the November 
issue of Outside Apple, Apple's newsletter for third-parly developers. Apple 
has seeded Claris with four Macintosh programs and AppleWorks. According 
to independentreports of retail software sales, AppleWorks by itself outsells 
the four Macintosh programs combined by a ratio of 3 or 4 to 1 You'd never 
know AppleWorks was so important to the company however, based on its 
public statements. 

For example, Kyle Mashima, Director of Product Development for Claris, 
notes in the Outside Apple article, "Adding one more significant publisher is 
a big deal. There aren't that many on the Macintosh side." Well, for starters 
there's Microsoft and Lotus, while on the Apple II side we have... well, we 
have... 

Will Claris do anything at all in the Apple II market? "An Apple II product 
would have to be really exciting, have broad appeal, and be a menu-driven, 
integrated package for us to consider it," Mashima says, "But would we? 
Sure." Do you think Mashima has ever booted up AppleWorks? Ifs already an 
excellent example of a really exciting, broadly appealing, menu-driven, 
integrated package. Or by 'menu-driven" does he mean "Xerox interface "? 
Do you suppose Claris will limit itself to integrated packages in the 
Macintosh market as well? 

Apple Itself has taken most of the profit out of the productivity portion of 
the Apple II software market for the last three years. In the process it has 
decimated Apple II productivity developers. Into this wasteland enters Claris 
with the Intention of soaking the remaining profit out of its AppleWorks cash 
cow and wasting it trying to compete with insignificant Macintosh developers 
like Microsoft and Lotus. The only thing I don't understand is where Apple 
and Claris think new Apple II productivity software will come from. 

Apple has won on all the chips on the Apple II software table and now wants 
to leave the game. This would make sense if Apple didn't also own the casino. 

Ilgs system disk 3.1 available 

Apple dealers have had a new system disk for the Ilgs for weeks 
already, and they'll let you copy it for free. However, the new disk, called 
system disk 31 still isn't shipping in the box with new machines. Dealers 
don't have the documentation that goes with this disk yet either. 

I haven't discussed the Ilgs system disk in Open-Apple before, so let's go 
over a few basics. First of all, learn to distinguish between disks that have the 
volume name /SYSTEM.DISK, disks that have the potential to be system 
disks, and disks that really are System Disks. 

Here in Open-Apple, the "System Disk" (capitalized) is the disk you 
booted from. This could be a FroDOS 8 disk, such as the AppleWorks startup 
disk, or a ProDOS 16 disk, such as the new /SYSTEM.DISKyour dealer will let 
you copy. (It could also be a DOS 3.3. Apple Pascal, CP/M, or MS-DOS disk.) If 
you boot the Ilgs with a Pro DOS 8 disk, you cannot run ProDOS 16 programs 
without rebooting. If you boot the Ilgs with a ProDOS 16 disk (that has all the 
right files on it), you can run either ProDOS 8 or ProDOS 16 programs. 

Important — ProDOS 16 works best when the System Disk (again, the disk 
you booted from) is "online" atall times. ProDOS 16 applications look on the 
System Disk for such things as fonts, desk accessories, RAM-based tools, and 
various kinds of drivers. If you take the System Disk out of the drive you'll 
frequently be prompted to reinsert it Anyone who ever used an original, one 
drive, 128K Macintosh will tell you how frustrating this is. 

Thus, it takes at least two drives to use ProDOS 16 programs efficiently— 
and if you have a Ilgs with two 3.5 drives, one of them is pretty much always 
going to have your System Disk in it when you run ProDOS 16 programs, flow, 
3.5 drives are nice storage devices, but they are relatively slow for this kind of 
use. 

1 recommend you buy a RAMdisk and just one 3.5 drive instead. Move all 
the needed /SYSTEM.DISK files over to the RAMdisk and boot from it Your 
computer will operate much faster and you'll spend less money if you buy 
and install the RAM chips yourself, rtow all you need is an easy way to load the 
RAMdisk in the morning. I'll get to that after we discuss exactly which system 
disk files you'll need to put onto your RAM-based System Disk. 

(You have two options for a RAMdisk. One is to add lots of memory to the 
Ilgs memory expansion slot and use a portion of it for a RAMdisk. To run 
ProDOS 16 programs well, however, you need a minimum of 512K of 
"desktop" memory; 1 megabyte is better. Any memory you use for a RAMdisk 
is in addition to this. Thus, you need 15 to 2 megabytes of gs memory ifyou 
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want to use the built-in RAMdisk. In addition, ifyou want to be able to boot 
from this disk after booting from a 3.5 you have to fiddle with the control 
panel. A second option is to use a standard slot-based RAM card, such as a 
RamFactor. The problem with this is finding a slot to put it in. Slot 7 works well 
unless you need it for AppleTalk or a hard disk; choices after that become 
very difficult) 

(And speaking of a hard disk, thafs another good place to put your System 
Disk. But the hard disk, obviously, must be your boot device for this to work.) 
Here are the files that are in the root directory of the new system disk 31: 



Filename 


Blacks Type 


Data 




PRDDOS 


39 


SYS 


14-JUL-87 


PQUIT, operating system loader 


SYSTEM 


1 


DIR 


23-SEP-B7 


tools. Fonts, and much mere 


SV5.UTILS 


1 


DIR 


5-NDY-87 


disk utilities 


BftSICSYSTEM 


?.l 


SYS 


18- JUN-94 


□Id fsithful, V 1.1 


BASIC. LAUNCHER 


3 


SYS 


12-JUL-B7 


It takes longer to load than to run 


APPLET RLK 


1 


DIR 


23-JUL-B7 


BppleTalk support SDftuara 


ICONS 


1 


DIR 


23-JUL-B7 


put Icon files in this susdi rectory 


DIRLDG.1CDN5 


H 


SCA 


9-APR-87 


uhat Is this and uhy is It here' 


CDPY.ME 


1 


BRS 


1E-JT1L-B7 


a da-nothlng file used by tutorials 


FINDCR.DATB 


1 


SC3 


S-NDV-B7 


the Finder created these Co remenber 


FINDER. ROOT 


1 


SIS 


S-NDV-B7 


desktop colors and positions 



The PRODOS file on a Ilgs system disk, as we've explained before, is quite 
different from the FRODOS file on a lie or lie system disk. The equivalent of 
the Ile/IIc PRODOS is actually in a file called P8 on the Ilgs, which well see 
later in the SY5TEM subdirectory. On the Ilgs, the PRODOS file is an 
"operating system loader." First it relocates a part of itself called PQU IT into 
an area of memory (the upper reaches of banks $E0 and $E1) where it will 
reside permanently. Itoct it loads ProDOS 16. Then it executes the stuff it finds 
in a subdirectory called SYSTEM .SETUP, which we'll find later in the SYSTEM 
subdirectory. Finally, it figures out what program it should run next and 
passes control to FQUIT. IfsPQUIXnotPRODOS, that actually loads and runs 
the selected program and the operating system it requires. 

The rules for "figuring out what program it should run" are these. First 
choice goes to a ProDOS 16 application program in the SYSTEM subdirectory 
called START. If there is no such file, the rules say to look in the main, or root 
directory for a file that either is a ProDOS 8 system program (type $FF) with a 
filename that ends in .SYSTEM, or a ProDOS 16 application program (type 
SB3) with a filename that ends in .SYS16. Whichever is found first is selected. 
If no suitable files are found, the user gets a sliding apple screen and has to 
reboot with another disk. If you by to boot a ProDOS 16 system disk on a II- 
Plus, lie, or lie, you'll get a similar error message saying you can't do that 

Mow, back to the /SYSTEM.DISK root directory. The second file shown is the 
SYSTEM subdirectory. We'll look inside it in a moment It holds a number of 
disk-based program and data files that are needed to run ProDOS 16 
applications. 

The SYS.UTILS subdirectory holds the newest version (3,0) of Apple's 80- 
column, 64K, ProDOS 8 system utility program. This is the program you use if 
you want to convert files between ProDOS, DOS 33, DOS 32, or Apple Pascal. 
(It will also catalog CP/M disks, but cannot convert CP/M files.) The file 
conversion process is quite easy— Just use the norma] COPY FILES option to 
copy a data file from a disk of one operating system to a disk of another 
(program files, of course, will be converted only in a "disk file" sense,- they 
usually won't run on the different operating system). The System Utilities 
program also performs all the standard file and disk manipulations such as 
formatting and copying disks and copy! ng, deleting, and renaming files. 

What 1 like best about this program is the interface. It's finally a true 
assembly language "magic menu" with windows (notice what happens when 
you ask for help) that conforms to Apple's Human Interface Guidelines for 
the Apple 11. Apple talks about its guidelines all the time in reference to the 
Xerox interface but has all but abandoned its own "magic menu" design; its 
good to see it in use on an Apple product here. But it's too bad Apple's 
guidelines are frozen in the days of DOS 3.3 rather than ProDOS. These 
utilities include no support for subdirectories, other than memorizing them 
and typing them in, Its amazing that neither AppleWorks nor these utilities 
offer the choice of choosing subdirectories by pointing at them and pressing 
return. Does anyone at Apple use ProDOS subdirectories? Is anyone at Apple 
aware of how third-party programs such as Copy II Flits support subdirectories? 

There are a few other things these system utilities don't do. The most 
important missing feature is the ability to convert files between ProDOS and 
Macintosh formats. Apple has written a Macintosh program called Passport 
that will do this, but there are far more Apple lis than Macintoshes in the 
world— an Apple II version makes more sense for a utility like this. The 
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program also lacks the ability to format DOS 3.3 disks, which earlier versions 
could do. 

The new llgs system disk also includes a new program called FAST- 
COFY.SYSTEM that uses llgs and standard-slot RAM for copying disks. Its 
faster and requires many fewer disk swaps than anything Apple has offered 
before, although products from Glen Bredon and Bill Basham have been 
doing this for months already. (If you've ever tried to copy a 3.5 disk with 
Apple's older utilities and a single drive, youll understand where this 
program iscoming from —you have to swap disks literally dozens or times.) 

If you have a lie or lie (or an 80-column 64K II-Plus, format matter), you'll 
find the new system utilities run on those computers too,although the Il-Flus 
and unenhanced lies will show strange characters where there should be 
MouseText lie and lie buyers nowadays get a system disk with their 
machines that Includes version 2.11 of the system utilities. 

The BASIC.SYSTEM that comes on the new llgs system disk is still version 
11 The date shown in the directory listing indicates how long its been since 
an update. This is the program that would execute if the re were no START file 
In the SYSTEM subdirectory. 

BASICLAUNCHER is part of one of the world's few programs that takes ten 
times longer to load than to run. I cannot tell you the exact function of this 
file If you try to run It it tells you not to do that. 1 assume it is used by 
LAUNCHER which is in the SYSTEM subdirectory. 

The APPLETALK subdirectory holds a number of files that you'll need If you 
want to use AppleTalk on your Hgs. Apple has still released no AppleTalk 
documentation for the Apple II that I can find, however, Don Lancaster has 
been taking llgs AppleTalk apart and writing up what he's found in his 'Ask 
the Guru" column in Computer Shopper. The December 1987 issue shows 
how to build the $130 Appl eTaik cables for about $10 and the January 1988 
issue shows how to send PostScript commands to the LaserWriter over 
AppleTalk, among other things. If you're using AppleTalk or LaserWriters, you 
should be reading Lancaster's column. 

The 1COMS subdirectory on the new system disk holds graphic images for 
various kinds of files. These images appear on your screen when you use a 
program called FINDER, which we'll look at later. Some commercial software 
comes with its own icon files; for best results, move these into the ICON 
subdirectory on your SYSTEM.D1SK, 

Logically, both APPLETALK and ICONS should be in the SYSTEM subdirectory, 
rather than cluttering up the root directory. I haven't yet had tim e to figure out 
if they work correctly if moved, however. The root directory of a ProDOS disk 
has a maximum capacity of 51 files. Subdirectories can officially have any 
number of files (although many programs, such as AppleWorks and FINDER, 
have definite limits to the number of files they can handle in a single 
subdirectory.) Whoever decided to put these files in the root directory isn't 
showing enough consideration for 20-megabyte hard disk users, who realty 
need to have nothing but PRODOS, SYSTEM, and their own subdirectories in 
the root directory. 

D1ALOG.1CONS is a rogue file. No one seems to know exactly what its for or 
why it's in the root directory. COPY.ME is a file that Apple's system disk 
tutorials use. It does nothing and has no other purpose. FINDER.DATA and 
FINDER.ROOT are data flies created by the FINDER program to remember 
howyou arranged, colored, and positioned this disk's icons the last time you 
had it on the FINDER desktop. These two don't appear on a virgin 
/SY5TEM.DISK, but will appear as soon as you manipulate the disk with 
finder. 

Now let's look in the SYSTEM subdirectory; 



Filename; 


Blocks 


Type 


□ate 




5VSTEM 


1 


D1R 


23-SCP-B7 




. <PB 


32 


SYS 


17-P.PR-FJ7 


ProDOS 6, \l 1.4 


..PIG 


75 


SF9 


M-JUL-B7 


ProDDS 16, V 1.3 


. .5TBOT 


1 


IB3 


13-JUL-B7 


boot-up PIS application program 


..SYSTEM. SETUP 


1 


MR 


27-PUG-87 


all rues in this dir s»Bcuts at boot 


....TOOL. SETUP 


sa 


we 


15-JJL-B7 


required 


AT INI T 


16 


*E2 


B-BPY-S7 


required uith RpploTalk only 


....flTLDAD.e 


1 


IBS 


,<-~-~---7 


rawed uith AppieTallt only 


....s:jnd.init 


I 


»B£ 


27-P.JG-B7 


requi red 


. -TOOLS 


i 


DIR 


27-A0G-B7 


this directory holds Rull-based tnols 


..DE5K.RCCS 


1 


OIR 


m 


no desk accessorise are supplied 


..0RIVER5 


1 


DIR 


23-SEP-B7 


PIE programs need these to print 


. . , . APPLE IALK 


6 


*8fi 


12-JJLB7 


required uith RppleTalk only 


....mfttMITER 


49 


iBB 


13-JUL-B7 




L.A5EPPREP 


56 


TXT 


2«-FEB-B7 


required uith LaserWriter only 


....LflSEKUHtTER 


53 


taa 


12-JUL-B7 


required uith LaserWriter only 


....nooai 


5 




13-flflY-B7 
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PRINTER 5 IBB 13-MPY-B7 

PRINTER. SEILP L BIN 23-5EP-87 

..FONTS 1 Did 23-JUL-B7 fonts for Pl£ prtiqrams 

..FINDER 102 SB3 22-JUL-B7 flicLntosh emulator, needs S12K llgs 

..LAUNCHER 12 *B3 I2-JUL-B7 world's slowest program selector 

.. CLIPBOARD 1 tW 23-5D"-87 disk-based clipboard for PIS pragrans 

P8 and PL6 are the one ProDOS 8 and ProDOS 16 files. On the new system 
disk 31 ProDOS 8 is version 14 and ProDOS 16 is version L3. P8 is the file 
you use to replace PRODOS on lie and lie ProDOS disks so that theyTI use the 
llgs dock. Delete PRODOS from a copy of your older disk, copy P8 onto ft, and 
rename P8 as PRODOS, 

START is the program that runs when the disk is booted. It can be any 
renamed ProDOS 16 application program. The START included on the new 
system disk 3.1 figures out how much memory is available on your llgs. If it 
can find atleast512K. it will run FINDER. If not, It runs LAUNCHER. If you use 
Glen Bredon's ProSEL, you'll want to replace this START file with the one on 
his /EXTRAS disk (if you have an older version of ProSEL without START and 
need an update, they're $5 from Bredon at 521 State Road. Princeton, nj 
08540; if you don't have it at all, get it -a new copy is $40), 

SYSTEM.SETUP is the subdlrectoiy that holds flies that are executed when 
the system is booted. The PRODOS file handles this, as mentioned earlier. 
Only files of certain types are executed, primarily types $B6 and $B7. 
According to the ProDOS 16 Reference Manual, types $B8 (new desk 
accessories) and $B9 (classic desk accessories) will also be executed If 
found in this subdirectory; however, according to Apple Developer Technical 
Support, the manual shouldn't have said that. Desk accessories are 
supposed to be in the DESKACCS subdirectory, not SYSTEM.SETUP. On 
system disk 31 four fllesare found In SYSTEM.SETUP. Two of them, ATLOAD.O 
and ATINIT, initialize AppleTalk. 

There is also a new public domain progra m available to add SY5TLM.SETUP 
abilities to ProDOS 8, It was written by Open-Apple subscriber Sean nolan 
and is called SETUP.SYSTEM. This program should be the first system file on 
your ProDOS 8 disks. If it is, ProDOSSwill run Itwhenyou boot and it will look 
for a subdirectory called SETUPS and run all the SYS and Bin files it finds 
there. Then i t will go back to the main directory and start up the next SYSTEM 
file. For more about Nolan's program, see his article in the November 1987 
Cali -A.P.P.L.Z., pages 14-23, and Bob Sander-Cederlof's article in the October 
1987 Apple Assembly Line, pages 29-32. Sander-Cederlof also discovered a 
new secret feature of ProDOS 8, versions 13 and later— they will search the 
root directory for a type $E2 file named ATirilT and run it before running the 
first.SYSTEM file. ATINIT, of course, is the AppleTalk initialization file found in 
the SYSTEM.SETUP subdirectory of ProDOS 16 disks. Nolan's solution for 
running programs tike ATINIT under ProDOS 8 is much more elegant than 
Apple's solution, but look for Apple's not-invented-here syndrome to prevent 
it from being used on future ProDOS 8 system disks. 

The TOOLS, DESKACCS, DRIVERS, and FONTS subdirectories in the 
ProDOS 16 SYSTEM subdirectory all hold files that are used by ProDOS 16 
application programs. Both TOOLS and FONTS hold a number of files on 
system disk 31—1 haven't listed them here. DESKACCS, on the other hand, 
is empty. Those of you who are used to the Macintosh may be surprised to 
leam that there is no need for a FONT/DA MOVER on the llgs. You simply use 
the FINDER or any other file manipulation program to move the fonts and 
desk accessories you want into the FONTS and DESKACCS subdirectories on 

desk accessories will be available to your ProDOS 16 programs. On the other 
hand, note that fonts or desk accessories that are not on the System Disk 
(again, the disk you booted from), are not available to your ProDOS 16 
programs. 

As mentioned earlier, the root directory file ICONS holds logically the same 
kind of stuff as FONTS and DESKACCS and should have been placed in the 
SYSTEM subdirectory. APPLETALK, which holds slightly different stuff, could 
go here too. 

The final three files in the SYSTEM subdirectory am FINDER, LAUNCHER, 
and CLIPBOARD. CLIPBOARD is a disk-based data file for ProDOS 16 
programs that support a Marin tosh-like clipboard. LAUNCHERis the kill-a-fiy- 
wittt-a-sledgehammer program selector you'll get if you boot Apple's 
/SYSTEM.D1SK on a llgs with less than 51 2K. Replace it as soon as you can 
with ProSEL, or add more memory so you can run FINDER, 

FINDER is a Macintosh desktop emulator. It allows you to copy, delete, 
rename, and startup files. It takes forever to start from a 3.5 inch disk, and 
apparently has some problems with hard disks largeT than 10 megabytes, 
but otherwise is a pretty decent program for novice users. Compared to the 
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Macintosh, the big difference is that this ftnderis in color. RAMdisks showup 
as little green logic boards. You can easily color-code your file folders (the 
icon for a subdirectory) if you want to. While the disk utilities that come with 
FroSELand Copy II Rusare still my first and second choices, there have been 
times when what I wanted to do was easier with finder, it's earned a place on 
my System Disk. 

What you put on your own System Disk is up to you, but it should be 
obvious by now that you don't actually need all the files on /SYSTEM-DISK. If 
you don't use AppleTalk, you don't need the APPLETALK subdirectory or any 
of the files in it you don't need the two AT files in SYSTEM.SETUF, and you 
don't need the APPLETALK file in DRIVERS. If you don't use a LaserWriter, you 
can also do away with LASEKPREP and LASERWRITER from the DRIVERS 
subdirectory. By ail means get rid of LAUNCHER in the SYSTEM subdirectory 
and BASIC. LAUNCHER in the root directory. COPY.ME should be deleted, of 
course, and SYS.UTILS and all its contents can be moved to an applications 
disk; there's no reason to have them on the System Disk. 

What you don't want to delete are any of the files in TOOLS.. When the next 
Hgs system disk comes outyou'll want to replace any updated tool files with 
the newer versions. You'll probably want to add files to FONTS, DESKJVCCS, 
and ICOMS. Get new files for these subdirectories from commercial and 
public domain disks. 

If you are a ProSEL user, remember to replace START with the ProSEL 
version. If you are also a RAMdisk user, proceed like this. First run your 
favorite program for initializing disks and format both a new 3.5 disk and 
your RAMdisk. Name the 3.5 something like /COLDSTART and the RAMdisk 
something like /RAMS. Without a separate formatting step, Apple's standard 
slot RAMdisks won't boot 

Next remove the 3.5 and copy all the files you want on your System Disk to 
the RAMdisk. Besides the core programs from Apple's /SYSTEM.D1SK, you'll 
find you have room for AppleWorks, the ProSEL utilities, and whatever else 
you use most often. But don't use more than 1525 blocks (about 760R). 

Next reinsert /COLDSTART and copy P8 from the /SYSTEM.DISK and 
RESTORE from your ProSEL disk onto it Rename P8 as PRODOS; rename 
RESTORE as RESTORE.SYSTEM. Next run the ProSELprogram BACKUP. When 
it asks you for the slot of the destination disk, enter a 0. It will then request a 
filename. Enter something like /COLDSTART/RAM. IMAGE. The program will 
then copy the entire contents of your RAM-based System Disk into a single, 
special file on the 3.5. 

Once all this is done, run the ProSfX program BLOCK.WARDEN. Enter P for 
prefix and /COLDSTART. Enter F for file and RESTORE.SY5TEM. Enter E for 
edit and use the arrows to move the cursor to byte 6. A special little window 
will appear. Enter the name of the file your RAMdisk backup is in, RAM.IMAGE. 
Dext go to byte 49 and hit the tab key (tab allows you to enter ASCII data). 
Enter the name of the program you want to run when RESTORE is finished; 
probably /RAM5/PRODOS. Hit the tab key again (back to hex data) and go 
back to byte 48 and enter the length of this string in hex, OC in this case. Press 
Escape to leave edit mode, W to write these changes onto the disk, and Q to 
quit 

You're done. Tomorrow morning turn on your computer and boot 
/COLDSTART. It will rebuild your System Disk in RAM and startup ProDOS 16 
in not much more time than it takes to start ProDOS 16 from the 3.5 to start 
with. Put /COLDSTART away and spend the rest of the day with immediate 
access to the programs in your RAMdisk (even Fmdertakes "only" about 10 
seconds to load). Use your 3.5 drive fordata disks. Write and tell us howyou 
like it 

Using the Advanced Interface 

Back in October, in the midst of our Tar More Than You Ever Wanted to 
Know About Apple II Character-oriented Interfaces" series. I mentioned that 
I'd include a longer assembly language example of how to use the Advanced 
Firmware Protocol (also known as Pascal 11 Firmware Protocol) "nextmonth 
(or so)." Here it is, brief as I can make it 

The advantage of using the Advanced Firmware (rather than the Basic 
Firmware), is that it has a STATUS command you can use to find out if a 
character has been received from an input device (modem/keyboard) or if an 
output device (modem/printer) is ready for the next character, in addition, it 
has an lMTcommandyou can execute without doing either a READ or WRITE. 
The Basic Interface has only READ and WRITE commands; the first READ or 
WRITE after PR# or IN* always initializes the firmware. 

(The advanced interface IN1T command should be used one time by your 
application program for each device you want to use. Its function is to reset 



the interface to its default dipswiteh/auxmem/control panel settings (see 
"Modes and defaults," page 3.75). The advanced interface does this even on 
the Super Serial Card (you might pencil this in about half-way down the first 
column on page 3.76— the problems with Super Serial Card initialization 
identified there. It turns out, apply only to the Basic interface and can be 
easily solved with an 1N1T call to the advanced interface.) To deselect a device, 
simply stop using it There is no need to use IN1T more than once unless you 
have some reason to set the device to its default values more than once.) 

(The advanced interface "ready for output?" status call can be used to 
determine whether a printer that is turned on is "selected" or not However, if 
a printer is completely turned off, this call returns with a "yes— ready" 
response. This is because a low voltage is used by printers to signal when 
they are ready— if the printer is turned off the voltage on this wire will 
definitely be low This is a hardware design flaw; its not the fault of the 
firmware.) 

The difficulty of using the Advanced Firmware is that Applesoft doesn't 
support it You can use it directly from assembly language, but there are so 
many combinations of slots, commands, entry point offsets, entry points, 
and register initializations that things can quickly progress past the point 
that anyone can understand them. 

For the sake of speed. It seems as if the way to proceed is to look up the 
entry point for each command/slot combination in advance, put the entry 
points for each slot in a table along with the proper X and Y register 
initialization values, then pull the proper stuff out of the tables just before 
each call. However, the entry points are already in tables, and pulling them 
out in advance is a waste of time. Instead, try the following routine. It's both 
fast and short Call it with your registers loaded as follows; 

Register contents uhen calling CHAR. ID 

X = slot numbBr of device (1-7 ualid, no testing done). 

V - command [13 i? ualid, no testing done). 
13 ■ INIT 
11 = READ 
IS = WRITE 

IS = CHARACTER RECEIVED? 
17 ' READY FDR OUTPUT? 

A - character to urita (WRITE command only) 



Register contents passed hack by CHAR. ID 

X - error code 

B = no error 
3 = illegal operation 
32-17 - Super Serial Card communications errors (see October, page 3.SB) 
54 - dEvlce error 

V = undefined 

A - character read [READ ccratand only) 

carry = answer to STATUS commands 16 4 17 (1=V, 0=N) 

The routine requires two zero-page bytes for temporary manipulations. As 
written, it uses bytes 6 and 7, which don't conflict with Applesoft the Monitor, 
DOS 3.3, or ProDOS, but which could conflict with other languages or other 
programs: 



CHAR. ID 

directs calls to Advanced Character l/O Firmuara 



• 

* 

■ 



by Tnm Weishaar, December 1987 





ZP.TEMP .EQ E 


Us need a tyo-byte pointer on page zero 




M5L0T SQ J7FB 


Interrupt handlers expect ICs here. 




CHAR. 10 




03aa:C0 10 


DPY BIG 


First, sge if coiMand is 16 or 17 


0302:36 m 


BCC ID. ALT 


if neither, continue at ALT entry 


0304 :F0 MS 


BED .1 


if IE, continue at .1 




DEY 


If 17. decrement Y to 16 and 


0397 :A9 00 


lda m 


put a in A (ready for output?) 


0309 :F0 82 


BED ID. ALT 


and continue at 10. ALT 


030B:A9 M. 


.1 LDA ttl 


iF IS, put 1 in A (character ready?) 




ID. ALT 




030D:4B 


PHA 


Save A on stack 


030E;3A 


Txft 


Using slot number that use passed in X, 


030F:0fl 


ASL 


create fefl for later, ana... 
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0313:00 


nsL 




0311 :0A 


BSL 




0312 :0A 


ASL 




0313:4B 


PHfl 


save it Dn the stac.<. 


0314: BA 


TXA 


Usiflg slot number that uas passed in X, 


0315:99 C0 


DRfl USC0 


create SCs, and... 


031/:AA 


TAX 


=ave it X, 3nd.._ 


03iB:B6 a? 


5TX 2P.TEI1P+I 


put it in our pointer. 


031A:A9 00 


LDfl H0 




031C:B5 0G 


STA 7P TEMP 


Pointer nnu hold^5 £C:>22. 


031E:B1 0G 


LDfl (ZP.TEMP) ,Y 


Using oFFset from Y, get entry point XX. 


0320.-B5 06 


!~;T= ZP.1EMP 


Pointer nou holds SCsXX. 


0322:GB 


PLA 


Ge t 50 and - - - 


0323: BB 


THY 


put it In V. 


0324 :EB 


PLP, 


Get original contents of A. 


«32S:BE F8 07 


STX MSLDT 


Fiji M5L0T for interrupt handlers. 


0328: BE FT CF 


STX ICFFF 


Turn off all IC800 ROMs (see p 3.B7). 


032B.-6C 86 00 


JMP (ZP.TEMP) 


Jump to slot/command entry point. 



This 46-byte routine takes care of finding the correct entry point for the slot 
and command you want of loading the registers with the required values, and 
of taking care of a couple of Super Serial Card bugs mentioned in the 
October issue near the end of page 3.67. It is also position-independent— it 
works anywhere. You can make it slightly faster by including tables of X and Y 
register values, but the speed advantage is slight (5 machine cycles), 12 extra 
bytes of space are requi ted, and it will no longer be position-independent If 
you're still interested, add these tables after the JMP (ZP.TEMP) and change 
the section from $30E to $316 to: 



LGA SLDT0.TABUT.-1,>: 



Get S0 ualue For this slot and. 
saue far later. 



incompatibilities between Applesoft and at least some Advanced Interface 
firmware, but the only conflict we've identified so far is limited to mixing the 
Advanced Interface with Applesoft low-resolution graphic commands. If 
anyone finds anything more specific by using the following demo program, 
please let us know. 

The difficulty of using a routine like CHARIO from Applesoft is that 
Applesoft has no commands for "register loading." You can CALL an 
assembly language routine from Applesoft, but you can't specify register 
contents before the call and you can't determine register contents after the 
call. So we have to write an assembly language "front end' for CHARIO that 
includes the ability to do these things for us. Then, from Applesoft, well PORE 
the register values we want to memory, CALL the new routine, and find what 
values were returned with PEEKs. 

Another difficulty of using CHARIO from a higher level language like 
Applesoft is that CI IAR.IO is written as a fast "low level," assembly language 
routine and consequently does no error checking. It will accept a slot 
number that doesn't support the Advanced Firmware or even a slot number 
that doesn't exist Itwill dutifully execute command #133 ifyou tell it to, even 
though there is no such command. In all such cases your computer will 
crash, lock-up, or worse. Error checking, if there is to be any, wil! have to be 
done by our "front end." 

This brings up the question of how one determines whether the device in 
any particular slot supports the Advanced Firmware protocol. Back in 
October (page 3.66) we discussed the identification protocol for advanced 
firmware; the followi ng "front end" includes a new command, TEST (command 
18), that determines whether a slot holds an advanced firmware device and, if 
it does, returns its identification byte: 



luh LbLui . iHbLL-l,X bet Ls ualue tor this sIdl. 






'-- 










* 






: CHBR.FP 




5LDT0. TABLE 


* 






: Applesoft "front and" For OHAR. 10 


.HS 10. 20. 33. 40. 58. £0-79 














C5LDT. TABLE 


• 






: by Tom Ueishaar, December 19B7 


.HS C1.C2.C3.C4.C5.CE.C7 














There are a number of ways to use CHARIO from an assembly language 








C-AR.FP 




program. For example, ifyou don't mind havingjust one current SLOT value. 


932E:A5 


0b 




LOA 


ZP.TEMP 


Saue the contents OF our temporary 


like Applesoft does, add a section of (C)haracter I/O commands that looks 
like this: 


0333:18 






v,-c 




zero-page bytes fpr safety's sake. 


0331: AS 


07 




LDA 


ZP.TEHP+I 






0333HB 






PHA 






C.TNTT 


0334 :AE 


9fJ 


01 


LDX 


SLOT 


Load slot number into X, 


LDY 1113 


0337 :F0 


1J 




BED 


ID. ERR 


if 0, report an error 


□ML LnHK.bU 


a j j j , 






CPX 


HB 


if 6 or sore. 


C.READ 


033B:B0 


zz 




BCS 


ID. ERR 


report an error. 


LDY n« 


0330: AC 


95 


1.2 


LDY 


CMD 


Load command number into Y, 


BNE CHAR. GO 


0340:C0 


00 




CPY 


H13 


i F less than 13, 


C. WRITE 


0312:90 


0t. 




BCC 


TD.ERR 


report an errpr. 


LDY HIS 


031^ :C0 


12 




CPY 


H1B 


iF 13 to IB, c»d le ok. 


BNE CHAR. GO 


031C:r« 


0G 




ee; 


te;t 


branch far command IB 


C.REBD.TE5T 


0348:90 


32 




BCC 


EE. 2 


branch for commands 13-17. 


LDY BIG 








10. ERR 






BNE CHAR.GD 


034A:A2 


03 




L0X 


»3 


Load TIIeshI Operation arror into X 


c. write. Test 


034biB.B 


3C 




BNE 


'ID. OUT 


and return to caller. 


LDY 1117 








TEST 






CHAR. GO 


034E:BB 






TXA 




Test slot Firmware to see if it 


LDX SLOT 


034F:09 


ra 




TRfl 


»C0 


supports the advanced interface. 


JMP CHAR. ID 


0351:65 


87 




STA 


ZP.TEMP+1 






0353:A9 


00 




LDA 


it® 




Nowall that would remain is for the programmer to load the A register with 


035S:BS 


0(1 




STA 


ZP.TEMP 


put ICs00 In pointer. 


a character before doing a WRITE, looking in the A register for a character 


0357 :B2 


0i 




LDX 


85 


after a READ, and branching off the carry for STATUS results (BCS = ready, BCC 
= not ready). It also might be interesting to look in the X register fc> r an error ' 


33i":EC 


n 


03 


.1 LDY 


TABLE, X 


get offset from tabla. 








DEX 






especially after irflT calls, but the lack of support for X register errors (see 


g--- .=■ 


BG 


12 


LDA 


(ZP.TEMP) ,v 


get ualue at this offset. 


page 3.68) generally makes this a waste of time. For example: 


035F:OD 
03G2:D0 


7G 
ES 


CMP 

S"JE 


TABLE. X 
10.ERR 


compare to correct id, not equal 
means no support, sand back error 


tp init slot 1 LOfl HI 


MBA-.Cd 






:ex 






STA SLOT Specify slot and... 


0365:16 


F2 




BFL 


.1 


try next offsst until all pass test 


J5R C.TMIT initialize a character device 


03G7:B0 


0C 




LDY 


UK 




TXA Test Fpr error. . . 


63E9:B1 


0G 




LDA 


[ZP.TEKP),V 


get device signature byte 


BNE ERROR problems uith initialization. 


03GB:BD 


98 


03 


5TA 


REACY 


put uhole thing in READY 


to read J5R C.READ Character returned in A register. 


03GE:29 


F« 




AND 


8SF0 


clear second hex digit 


037»:BD 


97 


03 


STA 


CHAR 


put uhat's left in CHAR 


printer ready' JSR C. WRITE. TEST 


0373:EB 






TNX 




make X^0 for no error 


BCS READY Printer online, paper pl< 


0374:F0 


1 = 




SEC 


10. OUT 












TABLE 






The final possibility we'll discuss here is using the Advanced Interface from 








.HS 


3B.05.1B.07. 


31.0B 


Applesoft. As mentioned in October (page 3.66), there are rumors of 


037G:3B 


05 


10 


07 01 0B 
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FZ.2 



037C 


flD 97 83 


LDfl CHAR 


Put charts'- fl. 


037F 


20 80 03 


JSR CHAR. ID 


Ube CHAR. I : -C.tE Elot/commanrl/char. 


e:a; 


BO 97 HI 


STfl CHAR 


5aua f) in CHAR. 


03BS 


R9 00 


LDA B0 


Saue carry in READY. 


03B7 


2fl 


ROL 




03BB 


BD 96 03 


STA READV 








ID. CUT 




03BB:BE 99 83 


STX ERROR 


5ave X In ERROR. 


03BE:GB 


Pt q 


Restore zero- pa ge temporary location. 


036F:B5 07 


STfl ZP.TEI1P+1 




0391.-GB 


pin 




6392:85 0E 


STfl 2P.TEMP 




E3 : J1 :£3 


RT5 


Done. 


0395:00 


CMD .DA 808 


fEEK/PDKE 917 


039G 


90 


SLOT .DA H00 


PEEK/POKE 91B 


0397- 


80 


CHAR .DA sea 


PEEK/PDKE 919 


039B 


98 


READY ,DR 800 


PEEK/POKE 920 


0399. 


00 


ERR3R .Eft 800 


PEEK/PDKE 921 



To play with these routines from Applesoft, you need to assemble them or 
hand-enter the hex codes. I tried both and was able to hand-enter them from 
the Monitor faster than I could find the disk my assembler is on. Most Apple 
fls nowadays also have a built-in Mini-Assembler (see May 1987, page 3.27) 
that you could use to enter the code. BSAVE the results in a file called 
CHAR.IO (A$300,L$9A). Then write yourself some playful Applesoft programs 
such as the following one 

10 HOME 

20 PRINT CHRS (4);"BLDAD CHAR.IO" 

25 CMD = 917 : SLDT = 91B : CHAR = 919 : REDY = 920 : ERR = 921 
30 Cir o£;;g; 

40 fi»(0J s "reserved" 

41 AJ(1] = "printer card" 

42 A$(2) - *-:■..■•-; / .-U card" 

43 Ai(3) = "serial/parallel card* 

44 AI(4) = "internal modem" 

45 As(5) = "sound /speech card' 
4S AJ(E) • "clack eard" 

4? AS(7) = "mass storage device" 
4B AJ[B) = "BB-CDlumn card" 

49 IW(9) = "netuDrk interface* 

50 fOfl 1=10 TD 15 : fi$(T) = "unknown" : NEXT 



100 PDKE CMD. IB : REM scan slots and TEST for advanced firmuare 

11.0 FDR S = 1 TD ? 

128 : POKE SLDT.S : REM CMD and SLOT «ust be specified before CALL 

138 : CALL 314 : REM call CHflR.FP 

148 i IF PEEK(ERR) THEN 160 : REM if EHH <> 6 then no advanced firmuare 
158 : PRINT "The device is slot »-;S;- is a *;AJ(PEEK(CHAR) / 16);-." 
160 NEXT 
190 END 




Miscellanea 



Ayear ago this month we were talking about the Smartport Mocfc-ortenfed 
firmware used by the Apple II for disk storage (contrast with the character- 
oriented firmware used for printers and similar devices). One of the 
commands we discussed, (page 2.92) was a status call to the Smartport 
itself, which is supposed to return the number of devices connected to the 
Smartport It turns out that on the original version of the memory- 
expandable 1 1c, making this call to the slot 4 firmware implied a RAMdisk was 
present whether the machine had a memory card plugged in or not 

This has been fixed in the "revised expandable He." You can identify 
these machines with a PEEK(64447) ($FBBF). The original lie had an $FF 
here, the original 3.5 ROM version a $00, the original memory expansion 
version a $03, and the current version a $04. You might want to pencil this 
into our "Apple II Family Identification Bytes" table on page 2.66. 

To figure out if there really is a card plugged into a He you should do a 
Smartport status call to the deuice (rather than to the Smartport, see page 
2.92 for complete details) and check how many blocks ol storage are 
available. If no card is plugged in, this field will come back filled with goose 
eggs. 

The latest revision of the He ROM also fixes a problem with keyboard 
buffering. Apple's Apple lie Technical JYotes #5, #6, and #7 have complete 
details. 

Our friends at Beagle Bros have moved. Their new address is 6215 
Ferris Square, Suite 100, San Deigo, CA 92121 Their new phone numbers are 
619-452-5500 (general), 619-452-5502 (technical support), and 619-452- 
5565 (bulletin board: 300/1200/2400, 8N1 full duplex). 




Ask 

(or tell) 

Uncle 



More feedback on reality 

In the midst of the December letter from Ben Kobb 
(page 3.84) you say you can't believe that Apple's 
Jean-Louis Gassee would say, "in no way, shape or 
form will we be in the office with this computer" (the 
llgs). 1 don't know whether any such statement was 
made; BUT I do know that an interview of Gassee 
published in Waldenbooks' ComputerfleuisiinJc this 
fall certainly inferred that only the Macintosh was 
meant for business. 

And here 1 sit, typing this note on AppleWorks and 
the He I have used for business since March 1983. 1 
have also purchased a llgs and expected great things, 
16 bits and whatever. Well, as you might guess, the 
best programs I have are AppleWorks, Apple, Writer, 

andPmSEL JimDeMoss 

Qrand Blanc, Mich. 



AsaprofessionaJ/oumaftst /should mam you that 
written interviews often reflect the feelings of the 
interviewer as much or more than the feelings of the 
inlenfieu!ee...Ms promised, I contacted Gassee on 
AppleLink and asked him to confirm ur deny the 
quotation and tell us why or why not he thinks the 
Apple U has a place in the office, llere'shis response; 

I think the Apple llgs has a privileged place in the 
school, the office, and at home. 

Jean-Louis Gassee 
Apple Computer, Inc. 

While his answer isn't all I would like It to be, it is 
something, and it is adequate. The people running 
Apple Inc are just that, people. They have been 
focused on their Macintosh line for three long years. 
Let's admit it, the Macintosh needed the attention. 
Without it, it would have gone the way of the Apple Hi 
and the Lisa. 

But now that the Macintosh can stand on its own 
feet and Apple's managers haue the second successful 
computer they've been working so long to develop, 
it's time for them to give the U One the attention and 
the tender loving marketing it deserves. Apple is 
simply not tapping the potential of the II family. Our 
jobs here are to open their minds to the possibilities. 
Apple's managers are intelligent, mofiuafed people 
who wSl respond to our arguments if we can persuade 
them of the truth we see. 

Uncle DOS has received a number of other letters 
from subscribers on these issues. The primary 
concerns are that Apple purposefully crippled the 



speed of the llgs microprocessor to auoid competing 
with the Macintosh, that 16 bit llgs software runs 
unacceptably slow, that the cost of the Apple II is too 
high when compared to MS-DOS machines, that 
comparatively little new software is being developed 
for the Apple II compared to MS-DOS and the Macin- 
tosh, and that Apple's Macintosh marketing has done 
more to convince people that the Apple tl isn't 
suitable for Business than it has done to convince 
them that the Macintosh is. 

The unusual thing is that when companies have 
products that are competing with each other, it is 
usually the established product that gets preference 
and the new product that is crippled. I have talked to 
the engineers who designed the llgs; I'm convinced 
that any speed limits they put on the machine are 
there because they didn't want to drive up the cost, 
not because they didn't want to scare their Macintosh 
colleagues. If Apple was worried about the llgs 
competing with the Macintosh, you can be sure the 
llgs wouldn't have memory expansion capabilities 
well beyond those of most Macintoshes. 

The problem is that Apple's managers seem bent 
on turning the Apple // into a cash couj— a mature 
product that produces money to be invested else- 
where - before Its time. If Apple would put the kind 
of resources into getting llgs software published 
that it has put into Macintosh software for the last 
three years, if Apple would resume marketing the 
Apple I! to adults as uieli as children, and if Apple 
would adjust its prices to meet the MS-DOS competi- 
tion, most of you would be happy. If you were 
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happy, you would sell Apple lis by wordof-mouth; 
something, it is apparent from your letters, many of 
you have stopped doing. 

Apple is not a monolith. II is not a stone rolled by 
an iron hand. It's people who respond to persuasion 
and the facts. We need to convince them that their 
current neglect is wasting the potential of the Apple 
g 

Warm French dough 

Include AppleWorks with tfie Apple II? This has 
been Apple's practice in Europe for some time as far 
as the He and lie go. Host people buy the packages, as 
buying individual components is much more expensive. 
Carrying this approach further, the standard Apple Ik 
in France now comes with the extra 256K memory 
card, yet is priced below what the lie sold for without 
the card. 

Apple France seems to recognize that Apple 11 
users now want that memory, and ifs not for playing 
games or anything other than AppleWorks. As Jean- 
Louis Qassee certainly knows, having played the 
major role in Apple's success in France, the Apple II 
has a significant small business and home office role 
here, and Apple marketing has not ignored that 
potential. 

Mow for the bad news. Apple France seems worried 
that AppleWorks Isn't a 16 bit program To show off 
the llgs they have bundled it with a painfully slow word 
processor, OS Write, along with a better paint program, 
QS Faint. 1 1 i s nice to get such software th i own in lo i he 
package and the llgs has been selling very well, but 
Hie real lucky people were those of us who bought the 
llgs before QS Write was ready; we were given Apple- 
Worksat no extra charge to tide us over. I expect most 
like I, after a little playing with the mouse and cute 
fonts, are back to using AppleWorks regularly and 
praying someone will listen to Frank Lowney's plea for 
a 16-bit version (December, pages 3.83-84). 

In sum, the Apple marketing and customer support 
I find here in France is far superior towhat I find in the 
States. Apples are not cheap here, but the well- 
developed product and company image makes con- 
sumers willing to pay the premium. When they go into 
most dealers, customers are presented with well- 
packaged systems, and the Apple lis aren't kept in the 
background, 1 really wish the parent company would 
learn a few of the tricks developed by its French 
offspring. 

Biirwitherelt 
Paris, France 

Everything in its place 

Frank Lowney's letter was exactly on targeL Like 
him, 1 own a number of the latest 16 bit programs like 
MultiScribe QS, yet AppleWorks is far and away my 
first choice. AppleWorks is on my screen in seconds, 
completely ready with enhancements from Beagle 
Bros, Pinpoint, and Applied Engineering- MultiScribe 
QS takes minutes. Getting MaclWfe up and going 
takes an intermediate amount of time. Using MacWrtf e 
without keyboard cursor control, however, is a pain in 
the chips. Your comments hit the mark precisely, too: 
why not /aster 16 bit software instead of bells and 
whistles. 

I teach using computers at a secondary school. In a 
twist of perceived convention, i use Macs to teach 
simplejunkbutuseApple lis in the advanced classes; 
for programming, graphics, robotics, engineering- 
related subjects, and so on, Because of its open 
architecture, the Apple II is a much more powerful 
machine than the Mac for our rather general purposes, 



nearly all the speed of the Mac is sacrificed to 
enormous bit-mapped take-along riles that the com- 
puter must fiddle with; the result is that for most 
actual uses, the Mac is no faster than the II. The Mac is 
wonderful, no question — but so is the Apple 1 1. 

Michael Simonds 
San Diego, Calif. 

AppleWorks 16 

In my letter published in last month's issue, I 
suggested we begin a realistic discussion of what a 
16-bit AppleWorks could and should do. In order to 
practice what I've preached, let me contribute at least 
one idea to the cause. 

The real genius of the AppleWorks filecard i nterface 
is that each screen communicates so much informa- 
tion in the context of what you are currently attempting 
to do. That is, you know where you've been, you know 
where you are, and you knowwhat options lie immedi- 
ately ahead. Mot only does this make the learning 
curve mercifully short and steep but it also invites 
exploration and, thus, innovation. But one wonders 
why this thinking was not extended to the way files are 
identified and brought to the desktop if the file you 
seek is not in the main directory or is an ASCII or DIF 
file. 

AppleWorks now contravenes the purposes of the 
FroDOS hierarchical file system. Looking beyond the 
main directory involves getting into the AppleWorks 
variant of Blind-Man's-Bluff unless you have the 
assistance of a remarkable memory or Randy Brandf s 
PathFinder. 

AppleWorks 16 will need to display the directory 
structure and allow the user to highligh t any subdirec- 
tory to view or select files from. And what about the 
return trip? It is quite likely that you will have several 
files on your desktop from different parts of the 
hierarchical file structure. If AppleWorks would remem- 
ber the origin of each file it could automatically save 
to the file's "home" subdirectory. Of course, itwouldn't 
be AppleWorks if k didn't a sk "Save file to . . . ?" At this 
point one could choose an alternate subdirectory 
from the directory structure display. 

Is there a better way to do it? Are there other ideas 
for AppleWorks 16 out there? Let's talk about it. 

Frank Lowney 
Milledgeville, Qa. 

End of the line? 

After all the talk about a 16-bit AppleWorks in the 
December issue, I felt compelled to write and contrib- 
ute my 8 bits. 

It should be made clear that AppleWorks 2.0 
already has 16-bit code. AppleWorks' memory man- 
agement and some of the display routines are con- 
tained in what is called the SubHosL Several versions 
of the Subfiost are on the AppleWorks startup disk — 
SEG.00 is the standard one for 128K machines, 
SEG.XM is for Apple-style memory expansion cards, 
and SEG.RM is for the llgs, SEG.RM Is written in 65816 
code, atthough that always seems to get ignored. 
Some 16-bit code is also found in APLWORIS-SYSTEM. 

Free tip; you can save disk space by deleting 
5ubflost files that don't apply to your hardware setup, 
this is especially handy when running AppleWorks off 
ofRAMdisks. 

Most of the desired enhancements you ask for at 
the en d of page 3.84 are already in place. When run on 
a llgs, AppleWorks is faster and allows a larger 
desktop, larger AWP files, and larger ADB files. If you 
make AppleWorks 2.0 think that it's running on a lie 
instead of a llgs using the patch on page 3.86, you 



lose out on the added speed of the 16-bit code and 
you're back to a 55K desktop and smaller fi le limits. 

As for developer enhancing, the Beagle Bros TJmeOut 
Series provides smoothly integrated applications 
such a graphing spell-checking, a programming 
language, printing with Macintosh fonts, and much 
more. The beauty of TimeOut is thatit even works with 
unenhanced lies, and it's available now; there's no 
need to dream and wait for the future. 

I'm all for bundling AppleWorks 2.0 with lis, but I 
think that any developer who decides to write the 
longed for "16-bit AppleWorks" is going to write it 
using the llgs graphics interface. The text version 
already exists in AppleWorks 2.0! 

Randy Brandt 
Beagle Bros, Inc. 

What Beagle Bros has done with AppleWorks 2.0is, 
of course, the model for much of what we've been 
talking about the last couple of months. But you 
guys have developed your knowledge of AppleWorks 
the hard way, by disassembling it and figuring out 
how it works. It's news to all of us, for erample, that 
there's 16-hit codein AppleHorfcs -2.0. Apple's press 
release didn't mention that, their advertising certainly 
hasn't bragged about it, their developer tech support 
people say it's not system software and they don't 
know anything about it Claris says its not ready to 
support it, and it's st/W the best-selling program in 
the Apple I! world. 

1 think we would all welcome an AppleWorks with a 
graphics interface if it was as fast as AppleWorks 2.0. 
The problem here is speed. // a graphics interface 
was as imixirtant as speed MouseCalc and the rest 
of mfemational Solution's software would still be 
with us. But speed is far more important, except for 
software that can only be done well with a graphics 
interface to begin with (drawing, graphing, desktop 
publishing). 

I! AppleWorks 2.0 is the fastest software we're ever 
going to get, well, that's not too shabby, and, as you 
point out, it runs on unenhanced lies. 1 find it hard to 
believe that spreadsheet recalculations and data 
base sorting and word processor replacing couldn't 
be markedly improued by rewriting if all in 65816 
machine code, howeyer. The problem is that Apple 
has managed to convince the people who haue to 
sell software, that only graphics-based programs are 
worth selling. Mow if it could jusf comrince th e people 
who buy software that speed isn't important, all 
would be right with itsvision of the world. 

The reason for the llgs defeater patch is to force 
^ppieHbrfcs {both 13 and 2.0} to expand into an 
Apple-sfule standard-slot memory card on the llgs, 
which it will absolutely refuse to do otherwise. We 
appreciate knowing the RAMifications and that we 
can delete the two SEG files we don't need from our 
fWfdisJcs. 




I cannot help feeling that there is something wrong 
with your patch to make AppleWorks think a llgs is a 
lie (page 3.86). APLWORKS.5YSTEM is only 8,531 
bytes long,- in this light, your B parameter of 13605 
seems a bit out of line. 

You may be pleased to leam that 1 have urged all my 
friends to buy their own Open-Apple subscriptions 
(mainly so they will stop borrowing my copies.) This 
should mean another $100 or so for you if they carry 
out their threats. 

Jerry E. Kindall 
Grove City, Ohio 
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Yep, those B parameters are about $2000 too high. 
Wot only that one of them points to a Jrtf /oiioicing 
the JSK $PE1T rather than to the JSR fit ux>uld stili 
icorfr, butit'snotwhalwesaid to do). Getuourpend! 
and change the 8 parameters shown on page 3.66 

(0: 

B5031 (V 1.3) B5408 (V 2.0) 

We don't mind you loaning out your copies; what 
bothers us is people who make photocopies without 
paying the required fees (IS cents per page per 
photocopy). 

More database crashes 

Your latest newsletter arrived just before I was 
going to sit down and write you a letter about a new 
bug! found In AppleWorks 2.0. Itappears that Eugene 
Whitehouse ("Database crash lead," December, page 
3.87) has also had the same problem. I have some 
more information that may help. 1 now have two 
failure examples from the same large data base. 

The first case had eight report formats. When I went 
through the data on the disk, the number-of-formats 
byte in the header still said eight, but there were only 
two formats on the dish. In the second case, the 
header said the file had eight formats, but there were 
only three. Something is causing report formats to be 
dropped in multiples of 600 bytes at a time. It 
appears to be a function of how full a disk Is. I can 
save to a disk and get an unreadable copy when the 
disk is full with a previous copy of the file. If I reformat 
the disk and save the same file the copy is readable. 
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I am mystified as to what is causing the problem. 
Curing the problem is as simple as identifying the 
number of formats that are really on the disk and 
correcting the number-of-format bytes to match. 
However, you do lose the missing report formats 
permanently. 

Sidney A. Powers 
Valencia, Calif. 

We also have another letter from suftscriberBrendan 
Hoar documenting the problem. It seems to happen 
only uihen a data base /lie is saued onto an almost 
full 5-1/4 floppy, One fact we can'i sort out from the 
letters we've seen is whether Applied Engineering's 
AppleWorks expansion software is required to make 
the bug appear. If any of you are able to replicate the 
bug, please do some tests with and without modi/ted 
softuwe and let us fcnou? what happens. 

Ilgs Smartport bug 

I recently discovered a bug in both the original and 
version 01 Ilgs ROMs. The problem occurs when you 
make a Smartport call to the firmware in slot 5. The 
firmware destroys locations $57 through $5A on the 
caller's direct page. This only occurs with Smartport 
calls (Le., calls to $C50D), not ProDOS calls (calls to 
$C50A). The old ROM sets the direct page to $0000 
prior to executing the offending code; this results in 
$57 through $59 on the "true" zero-page being 
trashed. The new ROM does not change the direct 
page, so $57 through $5A or the user's direct page 
are destroyed, 

I I is ironic that just a few Instructions after this code 
the firmware calls a routine that saves all the zero- 
page locations that It will be using. 

AJan J. Silver 
Yorba Linda, Calif. 

Backup bit clearing 

flow are you supposed to clear the backup bit in a 
file's ProDOS directory entry? The ProDOS Technical 
Reference Manual p. 172, Slates: "ProDOS sets bit 5, 
(he backup bit, of (he access field to 1 whenever the 
file is changed (that is, after a CREATE, RE11AME, 
CLOSE after WRITE, or SET_FlLEjriFO operation). 
This bit should be reset to whenever the file is 
duplicated by a backup program. Piote: Only ProDOS 
may change bits 2-4; only backup programs should 
clear bit 5, using SET fILEJriFO." 

According to the first sentence, calling 
SET_FILEJMFO will set the backup bit; the last 
sentence says that you should use SET_FILEJMFO to 
clear the backup bit How can SET-FiLfUMFO clear 
the backup bit if itaiways sets it? 

Paul Lucas 
Levittown,ri.Y. 

■Subscriber Paul Santa-Maria asJced this same 
question, but also pointed out that on page 94 of the 
manual, In the explanation of the System Global 
Page, there appears the following entry: 

BF1S: BUBIT 0FB ite ;cdnirols use of bacUup bit 

Dennis figured out that to clear the backup bit you 
need to store a $20 in BUBIT, then call SET-FIL/LOWO. 
This bit of information seems to be missing from all 
versions of the ProDOS 8 technical manuals. ProDOS 
16 has a whole new command for this, 
CLEARJiACKUPJUT. For more, see the October issue 
of Apple Assembly Line, page 26. Santa-Ma ria sent 
the same question there and Bob Sander-Cederlof 
also figured out the answer, which he explains in 
more detail 



Advanced interface bugs 

During the past three years, we have written prin ter 
and interface drivers for Time is Woney (TuiningPoint 
Software), Sideways (Punk Software), and Publlsh-m 
(Timeworksl. When we write these drivers, we try to 
follow existing standards. Our specific intent is to 
send data through She interface without any translation 
by the interface card. In the good old days, when 
standards were largely ignored, we would write data 
directly to the hardware ports of the Super Serial 
Card. 

When Apple released the lie, which wasn't compatible 
on a hardware level with the Super Serial Card, we 
wrote a second hardware-level driver. For the Ilgs we 
wrote a driver that uses the Pascal interface. We prefer 
the Pascal Interface over the Basic interface tor two 
reasons. First, we can Initialize the card without 
sending any data to the outputdevice (JSR$Cs00, the 
Basic interface initialization, always sends the character 
in the accumulator to the printer or other output 
device). Second, we can in itial ize the interface without 
the risk of hanging the computer. With the Basic 
interface, if the printer is off-line, the program will 
hang when you try to send data to it With the Pascal 
interface, it is possible to check the status of the 
output port before sending data. 

Unfortunately, the Pascal interface cannot be uni- 
versally used because of bugs in the Super Serial 
Card and the original lie ROMs, 

Revision 1 lie ROMs (the models that don't support 
3.5 drives) will not correctly return status because of a 
missing CMP #$10 al $C227 in the firmware. The 
result is that the status may be okay, but the result of 
the status call says it isn't This prevents using the 
Pascal interface with early lies. 

With the Super Serial Card, if you print with one 
program using the Pascal protocol and then printwith 
a second program without resetting or turning off the 
Apple, the second program will print without line 
feeds. When you initialize the interlace via Pascal, 
au tomatic linefeeds are turned off. When you initialize 
the interface via Basic, automatic linefeeds are 
supposed to be turned on, but as you point out on 
page 3.76, the Basic firmware won't reinitialize itself 
except after power-up or reset 

The reason is that in the early days, some pro- 
grammers sent all data to the printer by repeatedly 
calling $Cs00, rather than making a single call to 
$Cs00 and subsequent calls to address left in the 
output hooks at $36, which is the correct Basic 
protocol. In order to protect programmers who 
repeatedly called $Cs00. the Super Serial Card had to 
be designed so that it didn't really reinitialize itself 
after every call to $Cs00. 

Bruce D. Rosenbtum 
Turning Point Software 
Boston, Mass. 

Repeatedly calling $0,00 on the Ilgs will cause it 
to repeatedly reinitialize itself (which makes interface 
command codes seem not to work), so it's time for 
programmers to team how to correctly use either 
the basic Interface or the advanced (Pascal) interface. 
It's possible to solve the second problem you identify 
by using the Super Serial Card fteset command as 
part o/ your quit routine. See page 3.76 for an 
example of this: unfortunately, you have to send the 
command through the basic interface: the advanced 
interface ignores this command. Thanks for warning 
us about the status bug in the early lie. As you point 
out, it makes uniting a single, universal Inter/ace 
driver difficult to impossible. 



